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PREFACE 





This manual describes communication between a terminal user and the KRONOS Time- 
Sharing System. It contains an explanation of the subsystems available.to the terminal user, 
and the procedures which allow him to fully utilize the capabilities of these subsystems. 
However, this manual does not contain programming information for these subsystems. 

The following manuals contain additional information of interest to the remote time-sharing 
user: 


Title Publication Number 

Time-Sharing FORTRAN 59150900 

Reference Manual 

FORTRAN Translator (FTNTRAN) 59151000 

Reference Manual 

BASIC 59150800 

Reference Manual 

Text Editor (EDIT) 59150700 

Reference Manual 

In addition, the following manuals describe the KRONOS Time-Sharing System which was devel¬ 
oped by the Business and Industrial Systems Division of Control Data Corporation. 


Title Publication Number 

KRONOS Batch User's 59150600 

Reference Manual 

KRONOS Operating Guide 59151600 

MODIFY File Editing System 59151100 

Reference Manual 

EXPORT/IMPORT 59150500 

Reference Manual 

ALGOL 59151200 

Reference Manual 

KRONOS Terminal User's 59152000 

Instant Manual 


iii 
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INTRODUCTION 


1 


The KRONOS Time-Sharing System allows the terminal user to create, m ani pulate, execute, 
and save files consisting of programs and data. To execute a program from a terminal, the 
user must: 

• Identify himself to the computer and specify the subsystem to be used. 

The available subsystems are: 


BASIC 

Allows the user to solve mathematical and 
engineering problems. 

FORTRAN 

Allows the user to solve mathematical and 

engineering problems. 

EDIT 

Allows the user to edit files. 

EXEC 

Allows the user to run a previously compiled 

program. 


• Enter the commands necessary to process his job. 

• Log off when job processing is completed. 

Section 2 of this manual contains a sample program run. Section 3 provides an expanded 
description of time-sharing job processing. Section 4 lists and describes the control and 
job processing commands. Section 5 describes permanent file structure and the permanent 
file commands. Section 6 describes the program editing facilities available to the user. 
The special privilege commands are described in Section 7. 
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TIME-SHARING PRIMER 


2 


For the user who is unfamiliar with time-sharing, this section describes the steps for the 
successful operation of the KRONOS system by means of a simple example in the BASIC 
language. 

1. Dial the central site. If the procedure is unfamiliar, consult Appendix B. 

Dial-in is complete when the system prints: 

mm/dd/yy. hh. mm. ss. 

CDC TIME SHARING SYSTEM 

USER NUMBER: 

mm/dd/yy month, day, year 

hh. mm. ss. hour, minute, second 

2. Submit your user number on the same line: 

ABCDEFG (0) t 
The system responds: 

PASSWORD 


3. Enter your password in the blacked-out area: 

TUYWXYZ ( 0 ) 

The system prints: 

SYSTEM: 

4. On the same line, enter the subsystem to be used: 

BASIC 0) 

The system responds: 

OLD, NEW, OR LIB FILE: 

^Throughout this manual the convention (CR) (Carriage Return) is used to denote the 
RETURN key on the keyboard. 
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5. 


Submit the appropriate file status on the same line: 


NEW 

The system requests: 
FILE NAME: 


6. Enter the file name on the same line: 
PRIME 

The system responds: 



READY. 


To this point, the output has the following form: 

mm/dd/yy. hh. mm. ss 
CDC TIME SHARING SYSTEM 
USER NUMBER: ABCDEFG 
PASSWORD 

[TlUlVlWlXlYlZlM - 

SYSTEM: BASIC 

OLD, NEW, OR LIB FILE: NEW 

FILE NAME: PRIME 

READY. 


The password cannot be seen and 
is shown in this manner solely for 
purposes of illustration. 


7. Now we are ready to enter the BASIC program. In this case, we enter the program 
PRIME which prints the prime numbers. The program is entered as follows: 


10 

11 

20 

30 

40 

50 

60 

70 

80 

90 

100 

110 

120 

140 

160 

170 


PRINT "THIS IS A LISTING OF ALL PRIME NUMBERS" 
PRINT (CR) 

PRINT "WHICH PRIME THE PRIME NUMBER" (0) 

LET N=0 (CR) . 

LET V=0(f 
LET V=V+T (CRJ 
LET Y=INT (V/2+. 5) 

FOR X = 2 TO Y (CR 
LET Z=V/X (C 


(Z) (@ 


LET W=INT 
IF Z=W THEN 50 
NEXT X (CR) 
LET N=N+1 (CR) 


PRINT " 
GO TO 50 
END (CR) 


;N, 


;V (CR 
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8. The program is now ready to be executed. Type: 
RUN 

The system returns the following output: 



mm/dd/yy. hh. mm. ss. 

PROGRAM PRIME 

THIS IS A LISTING OF ALL PRIME NUMBERS 


WHICH PRIME THE PRIME NUMBER 


1 

2 

3 

4 

5 

6 

7 

8 
9 


1 

2 

3 

5 

7 

11 

13 

17 

19 


9. This program continues to print prime numbers until terminated by depressing 
either the S-key or break-key. 

The system responds: 

RUN TERMINATED. 


10. To log off the system, type: 


BYE 



This command logs off the user and outputs the following data: 


ABCDEFG LOG OFF. 
ABCDEFG CPU 


hh. mm. ss 
s. sss SEC. 


s. sss 


Central processor seconds used 
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TIME-SHARING JOB PROCESSING 


3 


This section explains the basic steps in processing a time-sharing job. 

• Terminal log-in 

• Subsystem selection 

• Program entry and execution 

• Terminal log-off 

To use the system from a terminal, the user must: 

1. Connect to the central site using one of the procedures described in Appendix B. 

When the connection is completed, the computer types: 

mm/dd/yy. hh. mm.ss. 

CDC TIME SHARING SYSTEM 

and requests: 

USER NUMBER: 


2. Submit the user number on the same line: 


xxxxxxx 



The user number consists of seven alphanumeric characters. 
The system then requests: 

PASSWORD 


3. 


Enter the password: 
zzzzzzz 

The password must consist of seven alphanumeric characters. To provide a greater 



measure of security, type the password in the area the system has blacked out. 


If no password is needed, type: 



If the user number and password are not acceptable, the system types: 


ILLEGAL LOG IN, TRY AGAIN 
USER NUMBER: 
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If the user number and password are acceptable, the system responds: 


SYSTEM: 


4. Enter the desired subsystem: 

BASIC (CR) to use the BASIC language 

EDIC (CR) to do text editing 

EXEC (CR) to execute a compiled program 

FORTRAN (CR) to use the Time-Sharing FORTRAN language 

To BASIC or FORTRAN, the system responds: 

OLD, NEW, OR LIB FILE: 

To EXEC, the system responds: 

OLD OR LIB FILE: 
to EDIT, the system responds: 

OLD OR NEW FILE: 


5. In answer to the response, submit the appropriate status: 


OLD ^R) 

for 

NEW (0) 

for 

LIB (6r) 

for 

The system responds: 



a file that was previously submitted 
a new file 

a file from the system library 


FILE NAME: 


6. Submit the file name: 
nnnnnnn (CR) 

The file name consists of up to seven alphanumeric characters. 

If an OLD or LIB file is specified but does not exist, the system responds: 
FILE NOT FOUND. 

If the file name submitted contains illegal characters, the system responds: 
FILE NAME ERROR. 

If no errors are detected, the system responds: 

READY. 

The following example illustrates a sample log-in: 
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11/02/69.11.00.00 
CDC TIME SHARING SYSTEM 
USER NUMBER: ABCDEFG 
PASSWORD 

ITIUlVIWIXlYlZ— - 

SYSTEM: BASIC 

OLD, NEW, OR LIB FILE: OLD 

FILE NAME: GEORGE 

READY. 


■> The password cannot be seen and 
is shown in this way solely for 
purposes of illustration. 


7. Enter the new FORTRAN or BASIC program (if either- of these subsystems is 
specified in Step 4). Type each line in the proper format. Each line must begin 
with a 1-5 digit line number and end with (CR) . 

At this time the user can enter any of the other commands described in Sections 4 
and 5. These commands include: 

• file action commands 

• terminal control commands 

• permanent file commands 

8. When all necessary file retrieval and file creation activity is completed 
for a program run or an edit operation, type: 

RUN (0) 

This command causes the FORTRAN or BASIC program to be run. This includes 
an old or library file being run under the EXEC subsystem. If the EDIT subsystem 
is requested, the RUN command causes the response: 

BEGIN TEXT EDITING 

The output of a BASIC or FORTRAN program is in the form: 

mm/dd/yy. hh. mm.ss. 

PROGRAM nnnnnnn 


(data requested or generated by the program — 
error messages if program errors occurred) 

RUN COMPLETE. 
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If the user wishes merely to generate object x code which can be saved and used at 
a later time, he enters the command: 


RUN, C = nnnnnnn (CRJ 
or 

RUN, COMPILE = nnnnnnn (cr) 

where nnnnnnn is the name of the file the object code is generated on. 


LOG-OFF PROCEDURE 


When the user completes job processing, he logs off the system using the following proce¬ 
dure. Type: 


BYE 



or 

GOODBYE 



This command logs off the user, purges all local files, and outputs the following informa¬ 
tion: 


xxxxxxx LOG OFF. hh. mm. ss 
xxxxxxx CPU s.sssSEC. 


xxxxxxx user number 

s.sss number of seconds of central processor time used 


ALTERNATE LOG-OFF/LOG-IN 

When the terminal is connected, the user may wish to allow another person to use the 
terminal. An alternate Step 1 is provided for this purpose. The user types: 


HELLO 



This command logs off the present user and reinitializes the log-in sequence. The system 
requests: 

USER NUMBER: 


The new user then proceeds with Step 2. 


SAMPLE TIME-SHARING RUN 

The following pages contain an example of a terminal rim. The commands used are described 
more fully in Section 4. The examples are shown here mainly to give the user an idea of 
the range of commands available. 


3-4 


59151300 Rev. A 




LIST 

10/23/69. 10. 25. 47. 

PROGRAM SECTEST 

10 PROGRAM SECTEST (TAPE2, OUTPUT) 
20 DIMENSION K(4) 

30 30 FORMAT (4(15, IX)) 

40 READ (2,30) (K(I),I = 1,4) 

50 PRINT 30, (K(I), 1 = 1, 4) 

60 END 

RUN COMPLETE. 


GET, TAPE2=DATA 
READY. 


RUN 


10/23/69. 10.26.29. 

PROGRAM SECTEST 

19690 25761 48304 27538 
END. 

RUN COMPLETE. 


RUN, C=SECB 

10/23/69. 10.27.06 

PROGRAM SECTEST 

RUN COMPLETE. 

SAVE, SECB 
READY. 

EXEC 

READY. 

OLD 

FILE NAME: SECB 
READY. 

GET. TAPE2=DATA 
READY. 

RUN 

10/23/69. 10.28.10. 

PROGRAM SECB 

19690 25761 48304 27538 
END. 

RUN COMPLETE. 


The LIST command is entered to obtain a 
listing of the file — in this case SECTEST. 

SECTEST is a brief FORTRAN program 
which reads a secondary file and prints 
four numbers from the file. 


This system response occurs after each 
execution of a LIST or RUN command. 

Before running SECTEST, the user 
must obtain the secondary file DATA 
from permanent file storage. 

The RUN command causes program 
SECTEST to be executed. 

The system supplies a program header 
for each program. 

The program output is printed as specified 
in FORMAT line 30. 


The RUN, C command causes the program 
to be compiled as SECB. 


The SAVE command is used to retain the 
object code for a later execution 

The user specifies the EXEC subsystem to 
execute the previously compiled program. 

The user supplies the OLD command and 
the file name SECB to the system. 


The secondary file DATA is retrieved from 
permanent file storage. 

The program SECB is executed (under the 
EXEC subsystem). 


The output is the same as when run under 
the FORTRAN subsystem. 
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PERMIT, ABCDEFG, SECB, E 
READY. 

PERMIT, ABCDEFG,SECB,N 
READY. 


STATUS 
TTY 12 

SYSTEM - EXECUTE 
FILE NAME: SECB 
STATUS - IDLE 


CAT LIST 
FILE NAME 
LEE 
TEST 
COMP 
EEE 
DATA 
SECTEST 
INMPLS 
TOMPLS 
TOKC 
TOMPLS 1 
MODS 
SECB 

END-OF-CATALOG 
RUN COMPLETE. 


OLD 

FILE NAME: EEE 
READY. 


LIS 

10/23/69. 10.30.07. 

PROGRAM EEE 

00100 REM PROGRAM EEE (OUTPUT) 
00110 X=0 

00120 FOR Y = 1 TO 5 
00130 Z=X+Y 
150 NEXT Y 
160 PRINT Y 
00180 END 

RUN COMPLETE. 

LENGTH, EEE 

1920 CHARACTERS. 


PURGE 

READY. 


The user grants permission to execute 
file SECB to user ABCDEFG. 

This command removes the permission 
granted in the previous command. 

This command is used to obtain the status 
of the terminal at which the user is 1 
running. 


The CAT LIST command is entered to obtain 
a listing of the files available under the 
current user's user number. 


The user requests a listing of EEE, using 
only the first three characters in the LIST 
command. 


The user requests the length of file EEE. 


The user removes EEE from permanent 
file storage. 


The user specifies another file. 
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CAT LIST ,F 


FILE NAME 

LENGTH 

CHARACTERS 

CREATION 

DATE 

LAST ACCESS 
DATE 


LEE 

1920 

08/15/69. 

08/15/69. 

The user obtains an 

TEST 

1920 

09/25/69. 

09/25/69. 

updated listing of the 

COMP 

36480 

09/25/69. 

09/25/69. 

files available using 

DATA 

1920 

10/23/69. 

10/23/69. 

the CAT LIST com¬ 

SECTEST 

1920 

10/23/69. 

10/23/69. 

mand. The F para¬ 

INMPLS 

4480 

10/07/69. 

10/22/69. 

meter is used to 

TOMPLS 

11520 

10/22/69. 

10/22/69. 

obtain additional 

TOKC 

8320 

10/22/69. 

10/22/69. 

information on each 

TOMPLS1 

21120 

10/22/69. 

10/22/69. 

file. 

MODS 

28800 

10/22/69. 

10/23/69. 


SECB 

41600 

10/23/69. 

10/23/69. 


END-OF- CAT A LOG 





RUN COMPLETE. 
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SYSTEM COMMANDS 


4 


After a user has logged in, he can enter any of The-'nyfstem commands. This section describes 
the terminal control and job commands. 


COMMAND PROCESSING 


The commands are entered from the terminal in a specified format. The system processes 
each command by checking from three to seven characters. The user must submit a mini¬ 
mum of three characters, but need not enter the entire command. For example, the user 
could specify the FORTRAN subsystem by entering any of the following commands: 


FOR (CRJ 
FORT (CR) 
FORTR (CR) 
FORTRA (CR) 
FORTRAN (CR] 


However, if a user enters one of several commands that are similar in the first three or 
more characters, the system responds: 

COMMAND NOT UNIQUE. 


The user must submit a sufficient number of characters to make the command unique. 

A user may enter a command and then wish to delete it. This is done in one of two ways: 

• By pressing the ESC (escape) key 

• By pressing both the CTRL (control) and X keys 


TERMINAL CONTROL COMMANDS 

The terminal control commands allowthe user to vary the source and format of information 
given to and received from the system. These commands, which may be given at any time 
after the user has logged in, are described below: 


ASCII 



This command specifies that all subsequent characters 
be read as belonging to the full ASCII set and thus converted. 
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AUTO, nn, ii (0) 


NORMAL (0) 


PARITY 0) 


After each carriage return, KRONOS automatically generates 
line numbers beginning with nn with an increment value of ii. 
If the parameters are omitted, the system assumes the values 
of nn=100 and ii=10. The user can override this mode by 
backspacing or by deleting the line and entering a command. 

KRONOS initially assumes this command has been entered. 
This command clears the TAPE mode, the PARITY mode, 
the ASCII mode, the special privilege ACCESS mode (see 
Section 7), and/or the MONITOR mode (see Section 7) selec¬ 
tions that previously have been made. 

This command specifies that all subsequent output to the 
terminal be transmitted with odd parity. 


TAPE 0 


This command permits subsequent information to be read 
from the paper tape reader. 


TIME-SHARING JOB COMMANDS 

Five basic types of job commands are available to the terminal user: 

• log-in 

• subsystem selection and control 

• job execution 

• file manipulation 

• log-off 

These commands are: 

BASIC 0 


BYE 0 


This command is used to specify the BASIC subsystem. If 
no primary file is currently specified, the system responds: 

OLD, NEW, OR LIB FILE: 

The user must then specify which one of the three file types 
he wishes to use. 

This command logs off the user, purges all files, issues 
accounting information, and disconnects the terminal. 
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The system replies: 


CLEAR 



DROP, lfn 



EDIT 



EXEC 



FORTRAN 



xxxxxxx LOGOFF, hh. mm. ss 
xxxxxxx CPU s.sssSEC. 

xxxxxxx user number 

s. sss central processor time used 

Purges all current files but retains the current primary 
file name. The system replies: 

READY. 

Purges the primary or secondary file lfn. 

After the file is dropped, the system replies: 

READY. 

If the file cannot be found, the system responds: 

FILE NOT FOUND. 

This command is used to specify the EDIT subsystem. If no 
primary file is currently specified, the system responds: 

OLD OR NEW FILE: 

The user must then specify whether he wishes to edit an old 
or new file. 

This command is used to specify the EXEC subsystem. If no 
primary file is currently specified, the system responds: 

OLD OR LIB FILE : 

The user must then specify whether he intends to execute an 
old or a library file. 

This command is used to specify the FORTRAN subsystem. 

If no primary file is currently specified, the system responds 

OLD, NEW, OR LIB FILE: 

The user must then specify which one of the three file types 
he wishes to use. 
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Same as the command BYE. 


GOODBYE 



HELLO 



LENGTH, lfn 



LIBRARY 



LIB, lfn 



This command logs off the current user, as in the BYE 
command, and reinitializes the log-in sequence. The 
system replies: 

USER NUMBER: 

The user enters his user number and continues with the 
log-in procedure. 

Calculates the length of the primary or secondary file lfn 
in terms of 640 character blocks (all rounding is up to the 
next multiple of 640 characters). The system replies: 

xxxxxxx CHARACTERS. 

AUows the user to obtain a file from the system library. 

The system replies: 

FILE NAME: 

The user must then submit the name of a file which is 
present in the system library. 

When the file is found, the system replies: 

READY. 

This is an optional form of the above command which allows 
the file name to be specified. 


LIST, N, xxxxx, F =lfn 



Prints the program at the terminal. 

N (when present) means that no header line is 
desired (used for punching paper tape). 

xxxxx Line where listing is to begin (optional). 

F=lfn (when present) means list file lfn. File lfn 

is not sorted. 

The system replies: 

mm/dd/yy. hh.mm.ss 
PROGRAM nnmmnn 

(program lines) 


RUN COMPLETE. 
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LNH, xxxxx, F = Ifn 



MEMORY, nnn 



NEW 



NEW, lfn 



An optional form of the LIST,N command specified above. 
Lists the file without a header. 

Allows the user to specify the octal field length nnn for the 
job. If nnn is omitted, the system assumes nnn = 100. The 
system replies: 

READY. 

Purges all current files and allows the user to specify a new 
file name. The system replies: 

FILE NAME: 

The user enters a valid file name. When the system accepts 
the file name, it responds: 

READY. 

This is an optional form of the above command which allows 
the user to specify the file name. 


NODROP 



NOSORT 



OLD 



This command allows a user to retain all secondary files 
from a previous run when changing primary files. It must 
be entered immediately after a NEW, OLD, or LIB com¬ 
mand is completed. The system replies: 

READY. 

Allows a user to prevent a file from being sorted on a LIST, 
REPLACE, RUN, or SAVE command. This command must 
follow all correction lines to be effective. 

The system replies: 

READY. 

Purges all current files and allows the user to access a 
file that previously was saved in the permanent file system. 
The system replies: 

FILE NAME: 
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The user must supply: 


OLD, pfn, xxxxxxx 



PASSWORD 



pfn, xxxxxxx 
pfn permanent file name 

xxxxxxx (optional) user number of another user whose 
files this user can access. The system allows 
a user to access the files of another user if he 
has at least an E permission level (see the 
description of the PERMIT command in 
Section 5). 

This is an optional form of the above command which allows 
the user to specify the file name. 

This command allows a user to change his password and 
provides a greater measure of security for his files. The 
system requests: 

OLD PASSWORD: 

iimim 

The user supplies the old password. The system replies: 

NEW PASSWORD: 

HIIVHIIII 



The user then supplies the new password and the system 
replies: 

PASSWORD CHANGED. 

If the old password submitted is illegal, the system replies: 
ILLEGAL OLD PASSWORD. 


RENAME 



Changes the current file name. The system replies: 

FILE NAME: 

The user enters any unused file name. After the name has 
been accepted, the system replies: 

READY. 

If the user has retrieved a secondary file by that name since 
the last RUN, the system responds: 

DUPLICATE FILE NAME. 
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RENAME, lfn 



This is an optional form of the above command which allows 
the user to specify the file name. 


RUN 



Compiles and initiates execution, initiates execution of the 
user program, or begins text editing. The system replies: 

mm/dd/yy. hh.mm.ss 
PROGRAM nnnnnnn 


(data or error messages) 


RUN COMPLETE. 


or 


RNH 



BEGIN TEXT EDITING. 

e 

commands/data/error messages 
RUN COMPLETE. 

This optional command allows the user to run the job with¬ 
out a header being printed. 


RUN, C=nnnnnnn (CRj 
or '—' 

RUN, COMPILE =nnnnnnn 



These commands allow a user to compile object code for a 
file to be saved in the permanent file system. This file can 
later be executed under the EXEC subsystem. The system 
replies: 

mm/dd/yy. hh.mm.ss 
PROGRAM nnnnnnn 




S (break key) 


SORT 



(diagnostic messages, if any) 

RUN COMPLETE. 

The user presses this key to terminate a job that is currently 
being output. The system responds: 

RUN TERMINATED. 

Allows the user to force sorting of the primary file. The 
system replies: 

READY. 
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STATUS 



STOP 



SYSTEM 



TIME, nnnnn 



Requests the current job status. A sample system reply 
could be: 

TTY 6 
SYSTEM - BASIC 
FILE NAME: DDD 
STATUS - IDLE 

Stops any run in progress. The system replies: 

RUN TERMINATED. 

Requests a new system name. The system replies: 
SYSTEM: 

The user can enter any command. Generally, the name of 
one of the four subsystems is entered. 

Allows the user to specify a time limit — nnnnn octal 
seconds — for the next operation requiring the central 
processor. If nnnnn is omitted, the system assumes 
nnnnn = 100g seconds. The minimum time that can be 
entered is 10g seconds. 
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PERMANENT FILE COMMANDS 
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KRONOS terminal users work with two types of files: primary and secondary. A primary 
file is specified for a system in response to the question FILE NAME; and can be listed, 
executed, etc. All other scratch files are secondary files. A user may use more than one 
secondary file, but can only work with one primary file at a time. 

The user catalog contains information on all saved files, a list of the users who have been 
granted access to each file, and the access level granted to each permitted user. 

FILE PERMISSIONS 

A user becomes the creating user of a file when he saves a file. The SAVE command stores 
the file and causes an entry to be made in the user's catalog. The catalog entry contains the 
creation date, length, and the date last accessed. 

The granting of explicit permission to another user causes an entry to be made in the creat¬ 
ing user's catalog. This entry contains the permission level and the user number of the 
permitted user. If a user attempts to access a file to which no access has been granted 
(through the use of the OLD or GET command), the system responds: 

PERMISSION NOT GRANTED. - if he enters an optional user number and 

the file is not found. 

FILE NOT FOUND. — if he does not enter an optional user number 

and the file is not found. 

A user may also be granted implicit permission to access the files of another user. The 
KRONOS service center personnel establish this permission by assigning a hierarchy of 
user numbers. This hierarchy defines a user/subuser relationship. 

When a user wishes to access files to which he has implicit permission, his user number 
must satisfy a user/subuser relationship. His user number must match the user number of 
the subuser in all n positions. 

The system does not compare user numbers in those positions where the user's (not sub¬ 
user's) user number contains asterisks. (When one position of a user number contains an 
asterisk, all subsequent positions of the user number will also contain asterisks.) 
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PERMANENT FILE COMMANDS 


PERMIT COMMAND 

The PERMIT command is used to grant file access permission. 


command is: 

PERMIT, xxxxxxx, pfn, p 



The general form of the 


xxxxxxx The user number of the user to be granted access permission, 

pfn The name of the file on which permission is to be granted, 

p Permission to be granted. The possible permission levels are; 


A — append only 
E — execute only 

N — none - removes previously granted permission 
R — read and/or execute 
W — write, read, and/or execute 


CATLIST COMMAND 

The CATLIST command allows the user to obtain information about files stored in the 
permanent file system. The general form of the command is: 

CATLIST, par am ( 0 ) 

If param is not specified, the names of the files created by the user are listed. Ifparam = F, 
the name, length, creation date, and the date last accessed of all files created by the user 
are listed at the terminal. If param is a user number, the system lists the files of that user 
providing the person requesting the listing has implicit or explicit permission. 


PERMANENT FILE PROCESSING COMMANDS 


The permanent file processing commands are: 


APPEND, lfn=pfn, xxxxxxx (CR 


Allows the user to append the contents of file 
lfn to file pfn. 


GET, lfn=pfn, xxxxxxx 



PURGE, pfn, xxxxxxx 



Allows a user to retrieve a primary or 
secondary file from a permanent file storage 
device. 

Allows a user to drop a file from the permanent 
file system. 
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REPLACE, 


lfn=pfn, xxxxxxx (CR^ 


SAVE, lfn=pfn 



UN SAVE, pfn, xxxxxxx 



Allows a us'er to substitute a new file for a 
file currently stored in the permanent file 
system. 

Allows a user to retain a file in the permanent 
file system. It does not allow a user to re¬ 
place a file in the permanent file system. 

Allows a user to drop a file from the perma¬ 
nent file system (same as PURGE). 


The parameters used in these commands are defined as follows: 

lfn local file name. This is the name given to the file when it is in use. 

pfn permanent file name. This is the name under which the file is stored 

in the permanent file system. (If omitted, pfn equals lfn. ) 

xxxxxxx the user number of another user (optional). This parameter is given 
when a user wishes to operate on the permanent files of a subuser (i.e. 
on a file on which he has implicit permission) or on a file to which he 
has been granted explicit permission. 
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PROGRAM EDITING 


6 


The EDIT subsystem (described in the Text Editor (EDIT) Reference Manual) provides general 
file editing capabilities to the user. In addition, to allow ease of editing when working with 
source programs,the user can perform program editing while using any other subsystem. 
This simplified editing capability allows him to: 

• insert statements into a program 

• delete statements from a program 

• correct statements in a program 


- The following example illustrates this program editing capability. The user types: 


10 

DET 

A=B 

(0) 

20 

LET 

C=D 

© 

25 

LET 

Z =A+B { 

30 

LET 

E=F 

© 

40 

LET 

G=I 

© 


If the user wishes to insert an instruction between the statements numbered 10 and 20, he 
types: 

15 LET X=Y @ 

If he wishes to delete statement 25 from his program, he types: 

25 (0) 

Finally, to correct statement 40, he types: 

40 GO TO 10 ( 0 ) 

When the file is listed, it has the following form: 


10 

LET 

A=B 

15 

LET 

X=Y 

20 

LET 

P 

11 

u 

30 

LET 

fa 

1! 

fa 

40 

GO TO 10 
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RESEQUENCING LINE NUMBERS 


It is often convenient to resequence the line numbers of a primary file. This is done by the 
use of the command: 

RESEQ, nn, ii 

nn the new line number of the first statement; 

if omitted, the system assumes nn=100 

ii the increment to be added to nn; if omitted, 

the system assumes ii=10 
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SPECIAL PRIVILEGE COMMANDS 


7 


The special privilege commands enable the KRONOS service center personnel to validate 
and communicate with users. Each user is grouped with others who may be monitored to¬ 
gether. This group of users is specified by the first three characters of the user number. 
The service center personnel can establish a user hierarchy among the users. This hier¬ 
archy creates a series of implicit file access permissions. The final four characters of 
the user number denote the specific user. 

The special privilege commands are: 

ACCESS (cR) Enables the user to identify himself as a special privilege user. 

The system replies: 

PASSWORD 

lllllllll 

The user enters the access password. If the password is valid, 
the system responds: 

READY. 

If the password is illegal, the terminal is disconnected. 

This command allows the user to add an answerback code to the 
validation entry for subuser nnnnnnn. The answerback code con¬ 
tains ten characters. It can be null or contain blanks. 

When the code has been added to the validation file, the system 
responds: 

ADDED. 

If user nnnnnnn does not exist, the system responds: 

USER NOT CREATED. 


ANSADD, nnnnnnn. 



ANSDE L, nnnnnnn. 



This command allows the user to delete an answerback code from 
the validation entry for subuser nnnnnnn. The answerback code 
contains ten characters. It can be null or contain blanks. 
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When the code has been deleted from the validation file, the 
system responds: 

DELETED, 

If tiser nnnnnnn does not exist, the system responds: 

USER NOT CREATED. 


CREATE, xxxxxxx, Allows the service vendor to validate a new user. The parame- 

aaa, pswd ters are: 

xxxxxxx user number of the subuser being created. It 

consists of seven alphanumeric characters. 

The first three characters must be the same 
as the first three characters of the creating 
user's user number. However, asterisks in any 
of the first three positions create an automatic 
match for any characters in the same positions. 

aaa Ten-character answerback code. This code is 

used with the user number and password to 
validate the user at log-in. If omitted, the 
answerback is not checked when the created 
user logs in. 

pswd User's seven-character alphanumeric file 

security password; if omitted, the password 
is not checked at log-in, 

The possible system responses to this command are: 

USER VALIDATED. — when the new user has been 

created. 

USER ALREADY CREATED— when the user number sub¬ 
mitted previously has been 
created. 


DIAL, nnn, sss 



Sends a one-line message to the terminal specified by the multi¬ 
plexer port number nnn. The maximum length of the message sss 
is one line, including the command. The user can dial those 
terminals with user numbers that match his in the first three 
positions. 
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The possible system responses to this command are: 

READY. — when the message has been sent. 

ILLEGAL USER ACCESS. — the user attempted to dial a 
terminal to which he does not have access. 

TTY NOT ACTIVE. — the desired terminal is inactive. 

MESSAGE TOO LONG. — the message is longer than one 
line. 

MONITOR, nnn To connect the calling terminal with the terminal specified by the 

multiplexer port number nnn. The input and output from terminal 
nnn is output at the calling terminal. The user can monitor those 
terminals with user numbers that match his in the first three 
positions. 

Possible system replies are: 

TTY NOT ACTIVE, — the terminal being requested is inactive. 

TERMINAL BEING MONITORED. - the terminal is already 
being monitored. 

ILLEGAL USER ACCESS. — the requested terminal cannot 
be monitored by the user. 


UNCREATE, xxxxxxx. To invalidate a currently valid user 

xxxxxxx The user number of the user being invalidated. 

(The first three characters of xxxxxxx must 
match the first three characters of the user 
number of the person submitting the command.) 

aaa Ten-character answerback code. Spaces are 

suppressed in answerback input. 



Possible system responses include: 


USER, xxxxxxx 



USER INVALIDATED. — the command has been processed. 
USER NOT CREATED. — the specified user was not found. 

Allows a user to determine to what multiplexer port(s) user 
xxxxxxx is currently connected. The user number submitted 
must match the user number of the user submitting the com-' 
mand in the first three characters. 
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KRONOS TERMINAL ERROR MESSAGES 


A 


■ Message 

COMMAND NOT UNIQUE. 

DUPLICATE FILE NAME. 

EXECUTE ONLY FILE. 

FILE NOT FOUND. 

FL TOO LARGE. 

ILLEGAL OLD PASSWORD. 

ILLEGAL PARAMETER. 

NO DATA IN FILE. 

NO SYSTEM DEFINED. 

PERMISSION NOT GRANTED. 

TOO MANY FILES. 

TOO MANY PARAMETERS. 


Description 

The user supplied the first characters that are not 
unique to one command. 

The permanent file requested has already been re¬ 
trieved. 

The user has only an E permission level on the file. 

The specified file does not exist. 

The field length — needed by the program as calcu¬ 
lated by the system or as specified in a MEMORY 
command — is greater than the system allows. 

The old password submitted after a PASSWORD com¬ 
mand does not exist or cannot be accessed by that 
user. 

The parameter specified is outside the allowable limits. 
The file specified is empty. 1 

The user attempted to RUN a program without speci¬ 
fying the system to be used. 

The user does not have write or append permission on 
the specified file. 

The maximum number of permanent files has already 
been retrieved. 

The user submitted more parameters than the com¬ 
mand requires. 
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TELETYPEWRITER DIAL-IN PROCEDURES 


B 


This appendix gives a brief explanation of howto connect the most common teletypewriter (TTY) 
models to KRONOS. 


CONNECTING TTY MODELS 33/35 

If the teletypewriter is hard-wired to the system., i.e., the telephone line is connected 
directly to the TTY, the following procedure is used: 

• Turn on the TTY by setting the rotary power switch in the LINE position or by 
depressing the ORIG button (on those models having such a feature). 

• Dial the correct connect code. The system returns a header, and TTY processing 
can begin. 

If the teletypewriter is connected to the system by an acoustic coupler, the following pro¬ 
cedure is used: 

• Turn on the TTY as described above. 

• Turn on the acoustic coupler. 

• Dial the correct phone number. 

• When the connection has been made, i.e., a constant high-pitched sound is heard, 
place the receiver in the acoustic coupler. The system returns a header, and TTY 
processing can begin. 

CONNECTING TTY MODEL 37 

To connect the Model 37 to KRONOS, use the following procedure: 

• Turn on the TTY by pressing the DATA button. 

• Follow the procedure described for Models 33/35 depending on whether the TTY 
is hard-wired to the system or connected to the system by an acoustic coupler. 
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PAPER TAPE FORMATS 


C 


Paper tape can be used to enter programs, commands, and data into the system from a re¬ 
mote terminal. The three paper tape modes (program, command, and data) can be used 
together on a single paper tape. This allows the entire terminal operation, after log-in, to 
be run on paper tape. Each paper tape mode has a distinct format associated with it which 
must be followed to ensure proper operation. Each tape begins and ends with at least an 
inch of rubout characters. 

LOADING PAPER TAPE 

If tape is placed into the reader before the TAPE command is entered from the keyboard, 
the user must place the Reader Mode switch in the READY position. If the tape is loaded 
after the tape command has been entered, he must start the tape reader. (Refer to the 
instruction manual for a description of the loading of paper tape into the reader. ) 


TAPE FORMATS 

Program Mode — The user must end each program line punched on paper tape 

by pressing the following sequence of keys: 

RETURN, LINE FEED, RUBOUT 

Command Mode — The user must end each command punched on paper tape by 

pressing the following sequence of keys: 

RETURN, LINE FEED, X-OFF, RUBOUT 

Data Mode — The user must end each line of data punched on paper tape by 

pressing the following sequence of keys: 

RETURN, X-OFF, RUBOUT, LINE FEED 
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COMMAND INDEX 

D 

Command 

Description 

Page 

APPEND 

Allows the user to attach information to a permanent file 

5-1 

ASCII 

Specifies that subsequent data belongs to full ASCII set 

4-1 

AUTO 

Automatically generates line numbers 

4-2 

BASIC 

Specifies the BASIC subsystem 

4-2 

BYE 

Logs off the user 

4-2 

CAT LIST 

Provides listing of files in the permanent file catalog 

5-1 

CLEAR 

Purges all current files 

4-3 

DROP 

Purges the specified file 

4-3 

EDIT 

Specifies the EDIT subsystem 

4-3 

EXEC 

Specifies the EXEC subsystem 

4-3 

FORTRAN 

Specifies the FORTRAN subsystem 

4-3 

GET 

Allows the user to retrieve a file from permanent file storage 

5-1 

GOODBYE 

Logs off the user 

4-4 

HELLO 

Logs off the user and reinitiates log-in sequence 

4-4 

LENGTH 

Calculates the length of a file 

4-4 

LIBRARY 

Allows the user to obtain a file from the system library 

4-4 

LIST 

Prints the program at the terminal 

4-4 

LNH 

Prints the program without a header 

4-5 

MEMORY 

Allows the user to specify a field length for his program 

4-5 

NEW 

Specifies a new file 

4-5 
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Command 

Description 

Page 

NODROP 

Prevents dropping of secondary files when switching 
primary files 

4-5 

NORMAL 

Clears all flags and specifies normal input 

4-2 

NOSORT 

Prevents file from being sorted 

4-5 

OLD 

Specifies an old file 

4-5 

PARITY 

Specifies that subsequent information will be in odd parity 

4-2 

PASSWORD 

Allows a user to change his password 

4-6 

PERMIT 

Grants explicit file access permission 

5-1 

PURGE 

Drops a file from permanent file storage 

5-1 

RENAME 

Changes the current program name 

4-6 

REPLACE 

Substitutes a new file for an old file 

5-2 

RESEQ 

Resequences line numbers on a file 

6-2 

RUN 

Compiles and initiates execution or only initiates execution 
of a program 

4-7 

RNH 

Runs a program without the header being printed 

4-7 

RUN, C or 

RUN, COMPILE 

Compiles a program 

4-7 

SAVE 

Allows a user to retain a file in the permanent file system 

5-2 

SORT 

Forces sorting of a primary file 

4-7 

STATUS 

Requests the current job status 

4-8 

STOP 

Terminates any operation generating output 

4-8 

SYSTEM 

Requests a new subsystem name 

4-8 

TAPE 

Specifies TAPE mode 

4-2 

TIME 

Allows a user to specify a time limit 

4-8 

UNSAVE 

Drops a file from permanent file storage 

5-2 
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